home *** CD-ROM | disk | FTP | other *** search
Text File | 1978-06-29 | 60.8 KB | 1,610 lines |
-
- ToolManager 2.1 Dokumentation
- ******************************
-
-
- Copyright und andere rechtliche Dinge
- **************************************
-
- Copyright (C) 1990-93 Stefan Becker
-
- Diese Dokumentation darf kopiert und weitergegeben werden solange die
- Copyright-Notiz und diese Erlaubnis unverändert auf allen Kopien
- enthalten ist.
-
- Es wird keine Garantie gegeben, daß die Programme, die in dieser
- Dokumentation beschrieben werden, 100%ig zuverlässig sind. Sie
- benutzen diese Programme auf eigene Gefahr. Der Autor kann auf *keinen*
- Fall für irgendwelche Schäden verantwortlich gemacht werden, die
- durch die Anwendung dieser Programme entstehen.
-
- Das Paket ist "freely distributable", aber das Copyright liegt
- weiterhin bei Stefan Becker. Dies bedeutet, daß es von jedem kopiert
- werden darf solange er nicht mehr als eine angemessene Kopiergebühr
- dafür verlangt. Diese Gebühr *darf nicht* höher sein als US $5 oder
- 5 DM.
-
- *Dieses Limit gilt auch für deutsche Public-Domain Händler!!*
-
- Dieses Paket darf in Public-Domain Sammlungen aufgenommen werden,
- insbesondere in Fred Fishs Amiga Disk Library (CD ROM Versionen dieser
- Sammlung eingeschlossen). Die Distributionsdatei darf in
- Mailboxsystemen oder auf FTP Servern abgelegt werden. Wenn Sie dieses
- Paket weitergeben wollen, dann *müssen* Sie die originale
- Distributionsdatei `ToolManager2_0bin.lha', `ToolManager2_0gfx.lha' und
- `ToolManager2_0src.lha' benutzen.
-
- Weder die Programme noch der Quelltext (oder Teile davon) dürfen
- ohne eine schriftliche Genehmigung des Autors in kommerziellen
- Programmen benutzt werden.
-
- Die Programme und der Quelltext (oder Teile davon) dürfen *auf
- keinen Fall* auf irgendeiner Maschine benutzt werden, die für die
- Forschung, Entwicklung, Konstruktion, Tests oder Produktion von Waffen
- oder anderen militärischen Gütern benutzt wird. Dies gilt natürlich
- auch für alle Maschinen, die für das Training von Personen in
- *irgendeiner* der obengenannten Tätigkeiten benutzt werden.
-
-
- Wichtige Bemerkungen
- *********************
-
- Willkommen zur wundervollen Welt von ToolManager 2.1 :-)
-
- - ToolManager und seine Konzepte wurden drastisch verändert (siehe
- Geschichte) seit der Version 1.5.
-
- - Beginnend mit der Version 2.0 ist ToolManager *GiftWare*. Wenn
- Ihnen dieses Programm gefällt und Sie es sehr oft benutzen, dann
- sollten Sie darüber nachdenken, ob sie dem Autor eine kleine
- Spende schicken um die Arbeit zu honorieren, die er in dieses
- Programm gesteckt hat. Ich schlage eine Spende in der
- Größenordnung von US $10-$20 oder 10-20 DM vor. Bitte schicken Sie
- mir außerhalb Europas keine Schecks, da es meistens mehr Geld
- kostet, diesen Scheck einzulösen, als überhaupt Geld darauf ist.
-
- Wenn Sie keine Spende schicken oder es sich nicht erlauben
- können, dann müssen sie sich nicht schuldig fühlen. Sie sollten
- mir aber trotzdem einen Brief schicken, wenn sie ToolManager
- benutzen (Ich liebe es Post zu bekommen :-). Siehe Adresse des
- Autors.
-
- - Benutzer von ToolManager 1.X/2.0 können mit dem Kapitel über die
- Schnellinstallation beginnen (siehe Schnellinstallation). Einige
- Merkmale haben sich nicht geändert und der Rest ist relativ
- einfach durch Ausprobieren herauszufinden. Für eine genaue
- Beschreibung des neuen Konzeptes und der neuen Merkmale schlagen
- sie bitte in dem Referenzteil dieser Dokumentation nach (siehe
- Objekte).
-
- Jede noch laufende ToolManager 1.X/2.0 Version *muß* entfernt
- werden oder die neue Version wird nicht funktionieren. Die neue
- Version kann leider nicht die Konfigurationsdateien der alten 1.X
- Versionen lesen.
-
- - Erstbenutzer sollten die ganze Dokumentation lesen, um das Konzept
- und den Zweck des Programmes zu verstehen. Beginnen sie mit
- Einfuehrung.
-
- - ToolManager 2.1 benutzt einige Merkmale der AmigaOS Version V38
- (und höher) und er unterstützt die neuen Netzwerkmöglichkeiten
- des AmigaOS, die (hoffentlich) bald für alle Benutzer zugänglich
- sein werden. Wenn sie noch die Version 2.0 benutzen (sie wird in
- dieser Dokumentation als V37 bezeichnet), dann brauchen sie keine
- Angst zu haben, denn ToolManager arbeitet auch ohne diese neue
- Merkmale. Alle erweiterten Merkmale sind in dieser Dokumentation
- markiert.
-
-
- Wohin man Bug reports, Kommentare & Spenden schickt
- ****************************************************
-
- Der Autor kann unter folgenden Adressen erreicht werden:
-
- Postadresse:
- Stefan Becker
- Holsteinstrasse 9
- 5100 Aachen
- GERMANY
-
- Bitte benutzen Sie nach dem 1. Juli 1993 die folgende Adresse:
-
- Stefan Becker
- Holsteinstrasse 9
- 52068 Aachen
- GERMANY
-
- InterNet Electronic Mail:
-
- stefanb@pool.informatik.rwth-aachen.de
-
-
- Wie man ToolManager 2.1 schnell installiert
- ********************************************
-
- Die grundlegende ToolManager 2.1 Installation besteht aus den
- folgenden vier Teilen:
-
- `Libs/toolmanager.library' => `LIBS:'
- Dies ist das Hauptprogramm von ToolManager. Es verwaltet alle
- Programme, Menüs, Piktogramme und Docks (siehe Library).
-
- `Prefs/ToolManager*' => `SYS:Prefs'
- Dies ist der Voreinsteller für die Konfiguration (siehe
- Voreinstellungen).
-
- `WBStartup/ToolManager*' => `SYS:WBStartup'
- Mit diesem Hilfsprogramm kann ToolManager gestartet und gestoppt
- werden. Wenn es in der WBStartup Schublade liegt, dann wird
- ToolManager immer automatisch beim Starten der Maschine geladen.
-
- `L/WBStart-Handler' => `L:'
- Dieses Programm startet Programme mit der Workbench-Startmethode.
- Es ist ein eigener Prozess, so daß man ToolManager auch dann noch
- verlassen kann, wenn man Workbenchprogramme gestartet hat.
-
- Nachdem Sie diese Dateien kopiert haben, sollten Sie eine noch
- laufende alte Version vom ToolManager stoppen und die neue Version
- durch Doppel-Klick des ToolManager Piktogramms im Verzeichnis
- `WBStartup' starten. Nun können Sie den Voreinsteller starten und mit
- den neuen Möglichkeiten herumspielen (Benutzen Sie das Gadget "Testen"
- statt "Benutzen"). Sie dürften die meisten Merkmale mit Trial & Error
- herausfinden. Für weitere Informationen schauen sie bitte in die
- Beschreibungen für die ToolManager-Objekten (siehe Objekte).
-
- Die Distribution enthält eine Beispielkonfiguration in der Datei
- `TM_Demo.prefs'. Sie können diese in den Voreinsteller mit dem
- Menüpunkt `Open' laden.
-
-
- Was ist ToolManager?
- *********************
-
- ToolManager ist ein flexibles Programm zur Verwaltung von
- Hilfsprogrammen in Ihrer Arbeitsumgebung. Es kann sowohl Workbench-
- oder CLI-Programme starten, ARexx-Skripte ausführen und Tastenbefehle
- erzeugen. Des weiteren kann es Befehle an einen ToolManager auf einer
- anderen Maschine schicken. Die Benutzeroberfläche besteht aus Menüs,
- Piktogrammen und Dock-Fenstern. Wenn Sie einen lauten Computer mögen,
- dann können Sie zu jedem dieser Dinge einen Ton hinzufügen. Siehe Ton.
-
- ToolManager kann Einträge zu dem Workbench `Hilfsmittel' Menü
- hinzufügen. Wenn Sie einen dieser Einträge auswählen, dann wird das
- dazugehörige Programm gestartet. Jedes Piktogramm, das zu diesem
- Zeitpunkt auf der Workbench ausgewählt ist, wird als Argument für
- dieses Programm benutzt. Menüeinträge sind nur dann möglich, wenn
- die Workbench läuft. Siehe Menue.
-
- ToolManager kann Piktogramme zum Workbench-Fenster hinzufügen.
- Falls Sie ein solches Piktogramm doppelklicken, dann wird das
- dazugehörige Programm gestartet. Wenn Sie einige Piktogramme auf dieses
- Piktogramm schieben, dann wird das Programm mit diesen Piktogrammen als
- Argumenten gestartet. Piktogramme sind nur dann möglich, wenn die
- Workbench läuft. Siehe Piktogramm.
-
- ToolManager kann ein Dock-Fenster aus einer Zusammenfassung von
- Programmen erstellen. Dieses Fenster kann auf jedem öffentlichen
- Schirm geöffnet werden. Jedes Programm wird durch ein Bild oder ein
- Textgadget repräsentiert. Um ein Programm zu starten brauchen Sie nur
- auf das Bild oder das Textgadget zu klicken. Falls das Fenster auf der
- Workbench geöffnet wurde und die Workbench läuft, dann können Sie
- auch einige Piktogramme auf das Bild oder das Textgadget schieben, um
- das Programm mit Argumenten zu starten. Siehe Dock.
-
- Weiterhin können Sie jedem Programm einen Tastenbefehl zuweisen.
- Wenn Sie diesen Tastenbefehl benutzen, dann wird das Programm
- gestartet. Beachten Sie dabei, daß in diesem Fall *keine* Argumente an
- das Programm übergeben werden können. Siehe Programm.
-
-
- Die Konzepte hinter ToolManager
- ********************************
-
- ToolManager 2.1 benutzt einen neuen objektorientierten Ansatz um ein
- flexibles und erweiterbares System zu ermöglichen. Dieser Ansatz
- machte viele Verbesserungen an den ToolManager 1.X Merkmalen möglich,
- z.B. man kann jetzt mehrere Dock-Fenster haben.
-
- Ein Objekt ist eine Zusammenfassung von Daten, die seine Merkmale
- beschreiben. Jedes Objekt hat einen Namen und einen Typ. Sie können
- von jedem Typ so viele Objekte erzeugen wie sie möchten, allerdings
- muß der Name jedes Objektes eindeutig sein, da er dazu benutzt wird um
- das Objekt anzusprechen.
-
- Momentan gibt es sieben verschiedene Objekttypen: Programm, Bild,
- Ton, Menü, Piktogramm, Dock und Zugriff. Die ersten drei Typen sind
- einfache Objekte, d.h. sie verweisen auf keine anderen Objekte. Sie
- stellen den komplexen Objekten Daten oder Dienste zur Verfügung.
-
- Die letzten vier Typen sind komplexe Objekte, d.h. sie verweisen auf
- einfache Objekte und benötigen deren Daten oder Dienste. Der Verweis
- geschieht aufgrund des Namens und falls kein einfaches Objekt mit
- diesem Namen existiert, dann ignoriert das komplexe Objekt es. Beachten
- Sie dabei, daß dies die Funktionalität des komplexen Objektes
- beeinträchtigen kann, z.B. benötigt ein Piktogrammobjekt die Daten
- eines Bildobjekts, anderenfalls wird es kein Piktogramm erzeugen.
-
- Für eine detailierte Beschreibung aller Objektparameter siehe
- Objekte.
-
-
- Ein paar Beispiele
- *******************
-
- Haben Sie bis jetzt kein Wort verstanden? Sind Sie verwirrt durch
- Objekte, Programme und Referenzen? Verzweifeln Sie nicht, denn Hilfe
- ist unterwegs.
-
- Ich werde Ihnen nun Schritt für Schritt ein paar Beispiele zeigen,
- wie Sie ToolManager konfigurieren. Sie müssen dazu nur ToolManager
- installieren und den Voreinsteller starten. Nach jedem Schritt benutzen
- Sie bitte das Gadget "Testen" im Hauptfenster, um die Konfiguration zu
- testen.
-
- Wir benutzen das Textanzeigeprogramm More aus dem Verzeichnis
- `SYS:Utilities' für unser Beispiel. Als erstes müssen wir ToolManager
- sagen, welches Programm wir benützen möchten. Informationen über
- Programme werden in Programmobjekten abgespeichert. Also wählen Sie
- jetzt "Programm" als Objekttyp im Hauptfenster des Voreinstellers und
- drücken das Gadget "Neu".
-
- Nachdem Sie das Gadget gedrückt haben, sehen Sie das "Ändere
- Programmobjekt" Fenster. Nun öffnen Sie das Verzeichnis Utilities auf
- Ihrer Workbench-Partition und schieben das Piktogramm "More" auf das
- neue Fenster des Voreinstellers. Wie Sie jetzt sehen können, sind der
- Name des Objekts und der Befehl auf "More" gesetzt, während das
- aktuelle Verzeichnis auf "SYS:Utilities" gesetzt wurde. Drücken Sie
- nun das "Benutzen" Gadget um diese Einstellungen zu übernehmen.
-
- Da man mit einem Programmobjekt allein nicht viel anfangen kann,
- wollen wir nun dieses Programm zu dem `Hilfsmittel' Menü der Workbench
- hinzfügen. Dazu wählen Sie "Menü" als Objekttyp und drücken das
- Gadget "Neu". Nun sehen Sie das "Ändere Menüobjekt" Fenster. Setzen
- Sie den Namen des Objekts auf "Text anzeigen".
-
- ToolManager muß wissen, welches Programm er starten soll, wenn der
- Menüeintrag ausgewählt wird. Daher erstellen wir eine Referenz von
- dem Menüobjekt zu einem Programmobjekt. Drücken Sie das Gadget
- "Programmobjekt" und wählen sie von der Liste das Objekt "More" aus.
- Nun drücken Sie das Gadget "Benutzen" und dann "Testen" im
- Hauptfenster. Jetzt können Sie eine Textdatei auf der Workbench
- auswählen und den neuen Menüeintrag anwählen. Das Programm "More"
- sollte starten und Ihren Text anzeigen. Das war doch einfach, oder?
-
- Nun können wir einen Schritt weitergehen und ein Piktogramm auf der
- Workbench erzeugen. Für ein Piktrogramm benötigen wir Grafikdaten,
- die in Bildobjekten abgelegt sind. Wählen Sie "Bild" als Objekttyp und
- drücken Sie das Gadget "Neu". Das "Ändere Bildobjekt" Fenster öffnet
- sich. Setzen Sie den Namen auf "Bild für More" und legen Sie das
- Piktogramm von More aus dem Verzeichnis Utilities auf das Fenster.
- Drücken Sie das Gadget "Benutzen" zur Übernahme der Einstellungen.
-
- Im nächsten Schritt erstellen wir das Piktogramm. Wählen Sie
- "Piktogramm" als Objekttyp und drücken Sie das Gadget "Neu". Setzen
- Sie den Namen des Objekts auf "Text anzeigen". Drücken Sie das Gadget
- "Programmobjekt" und wählen Sie das Objekt "More" von der Liste aus.
- Drücken Sie das Gadget "Bildobjekt" und wählen Sie das Objekt "Bild
- für More" von der Liste aus. Setzen Sie die X Position auf 100 und die
- Y Position auf 50. Nun drücken Sie die Gadgets "Benutzen" und
- "Testen". Nach einer kurzen Pause sollte ein Piktogramm auf Ihrer
- Workbench erscheinen, auf das Sie die Piktogramme Ihrer Textdateien
- legen können, um diese anzuzeigen.
-
- Nun sollten Sie in etwa verstanden haben, wie man
- ToolManager-Objekte benutzt und in welcher Weise man sie kombinieren
- muß, damit eine Konfiguration entsteht. Jetzt sollten Sie den Rest der
- Möglichkeiten durch Ausprobieren herausfinden. Sie können sich auch
- die Beispielkonfiguration in der Datei `TM_Demo.prefs' anschauen.
-
-
- Beschreibungen für alle Dateien in der Distribution
- ****************************************************
-
- Die ToolManager 2.1 Distribution besteht aus mehreren
- Verzeichnissen, die alle weiter unten erläutert werden. Beachten Sie
- bitte, daß die Distribution in drei Teile aufgespalten ist, d.h. es
- können einige Verzeihnisse nicht vorhanden sein.
-
-
- Das Docs Verzeichnis
- =====================
-
- Dieses Verzeichnis enthält die Dokumentation für ToolManager. Die
- Dokumentation ist in vier verschiedenen Formaten und verschiedenen
- Sprachen vorhanden. Weiterhin existiert eine Datei in dem
- AutoDoc-Format, die die ToolManager shared library Schnittstelle
- beschreibt.
-
- Prefix `TM_<Sprache>'
- Diese Datei enthält die Dokumentation in der angegebenen Sprache.
- Momentan sind folgende Sprachen vorhanden: Deutsch, Français,
- English, Svenska.
-
- Postfix `.doc'
- Diese Datei enthält die Dokumentation als einfacher ASCII-Text.
-
- Postfix `.dvi'
- Diese Datei enthält die Dokumentation in TeXs DVI-Format. Um
- daraus eine gedruckte Dokumentation zu erstellen, müssen sie
- diese Datei durch einen TeX Druckertreiber schicken.
-
- Postfix `.guide'
- Diese Datei enthält die Dokumentation im AmigaGuide-Format.
- Obwohl dieses Format nur aus einfachem ASCII-Text mit ein paar
- Befehlen besteht, benötigen Sie AmigaGuide um die Hypertext
- Verkettungen nutzen zu können.
-
- Postfix `.tex'
- Diese Datei enthält die Dokumentation im Texinfo-Format. Dieses
- Format wurde von der Free Software Foundation (FSF) erfunden.
- Zusammen mit dem `texinfo.tex' Makropaket können sie TeX und
- `texindex' benutzen, um eine Datei im DVI-Format zu erstellen
- (siehe oben).
-
- `toolmanager.doc'
- Diese Datei beschreibt die ToolManager shared library
- Schnittstelle im AutoDoc-Format.
-
-
- Das Goodies Verzeichnis
- ========================
-
- Dieses Verzeichnis enthält zusätzliche Programmpakete, die
- nützlich für ToolManager sind.
-
- `GetPubName.lha'
- Dieses kleine Programm gibt den Namen des obersten öffentlichen
- Schirms auf die Standardausgabe oder in eine Umgebungsvariable
- aus. Es wurde geschrieben von Michael "Mick" Hohmann.
-
- `upd1_20.lha'
- Das Programm `upd' wurde geschrieben von Jonas Petersson. Es ist
- ein kleines Program, daß einen ARexx-Port öffnet und auf Befehle
- wartet. Mit Hilfe von ARexx können Sie `upd' veranlassen
- digitalisierte Töne und Geräusche abzuspielen. ToolManager
- benutzt diese Eigenschaft um seine Tonobjekte zu realisieren.
- Siehe Ton.
-
-
- Das Graphics Verzeichnis
- =========================
-
- Dieses Verzeichnis enthält eine reichhaltige Sammlung von Bildern
- aus denen Sie wählen können. Laden Sie sie einfach als Bildobjekte in
- ToolManager (siehe Bild).
-
- Die Dateien wurden von verschiedenen Personen zur Verfügung gestellt
- (siehe Danksagungen). Jeder von ihnen hat ein eigenes Unterverzeichnis
- erhalten. Da diese Dateien von verschieden Personen erstellt wurden,
- stammen sie aus verschiedenen Umgebungen (Farbpalette, Tiefe,
- Auflösung, Größe) und haben unterschiedliche Desginstile. Es kann
- also durchaus vorkommen, daß sie nicht gut auf Ihrem Rechner aussehen.
-
- Damit man die unterschiedlichen Formate, die von ToolManager
- unterstützt werden, unterscheiden kann, hat jeder Dateiname einen
- speziellen Postfix:
-
- `.anmb'
- Dies ist eine IFF ANIM Datei, die von einem Mal- oder
- Animationsprogramm erstellt wurde. Sie kann mehrere Bilder
- enthalten. Obwohl ToolManager komplette ANIM Dateien laden kann,
- sollten sie eine ähnliche Funktion wie DPaints "AnimBrush"
- benutzen, um den interessanten Teil aus der Animation
- herauszuschneiden.
-
- `.brush'
- Dies ist eine IFF ILBM Datei, die von einem Malprogramm erzeugt
- wurde. Sie enthält nur ein Bild.
-
- `.info'
- Dies ist eine normale Amiga Piktogrammdatei, die durch IconEdit
- (oder etwas ähnliches) erzeugt wurde. Sie kann zwei Bilder
- enthalten.
-
-
- Das L Verzeichnis
- ==================
-
- Dieses Verzeichnis enthält nur eine Datei, nämlich
- `WBStart-Handler'. Sie *müssen* diese Datei in das `L:' Verzeichnis
- kopieren, sonst kann ToolManager keine Programmobjekte mit der
- Workbench-Startmethode starten (siehe Programm).
-
- Das komplette WBStart 1.2 Paket befindet sich auf Fish Disk 757.
-
-
- Das Libs Verzeichnis
- =====================
-
- Dieses Verzeichnis enthält nur eine Datei, `toolmanager.library'.
- Dies ist das Hauptprogramm von ToolManager und muß in das `LIBS:'
- Verzeichnis kopiert werden.
-
-
- Das Locale Verzeichnis
- =======================
-
- Dieses Verzeichnis enthält alle Dateien für die Lokalisation von
- ToolManager. Da die locale.library erst in V38 enthalten ist, brauchen
- Sie keine dieser Dateien zu kopieren, falls sie noch V37 benutzen. Wenn
- Sie schon V38 benutzen, dann wählen Sie die Ihrer Sprache
- entsprechende Datei.
-
- `Catalogs/<Sprache>/toolmanager.catalog'
- Dies ist eine Übersetzungsdatei für die angegebene Sprache.
- Kopieren Sie die Datei für Ihre Sprache in das Verzeichnis
- `LOCALE:Catalogs/<Sprache>'.
-
- `Languages/<Sprache>.language'
- Einige Sprachen werden noch nicht unterstützt von der Standard
- V38 Locale Distribution. Daher haben einige Übersetzer eine
- `.language' Datei mitgeliefert, damit ToolManager ihre
- Übersetzungsdateien benutzen kann. Kopieren Sie die Datei für
- Ihre Sprache in das Verzeichnis `LOCALE:Languages'. Es sind
- folgende zusätzlichen Sprachen verfügbar: Finnish (suomi),
- Eefeler Platt (eifel).
-
-
- Das Prefs Verzeichnis
- ======================
-
- Der ToolManager Voreinsteller und sein Icon befinden sich in diesem
- Verzeichnis. Kopieren Sie beide Dateien in das Verzeichnis `SYS:Prefs'.
- Für weitere Informationen siehe Voreinstellungen.
-
-
- Das Programmers Verzeichnis
- ============================
-
- Dieses Verzeichnis enthält alle Dateien, die von den verschiedenen
- Programmiersprachen und deren Compilern benötigt werden, um die
- ToolManager shared library Schnittstelle zu benutzen. Das
- Unterverzeichnis `examples' enthält mehrere Beispiele dazu. Für eine
- komplette Beschreibung der Schnittstelle lesen Sie bitte die Datei
- `Docs/toolmanager.doc'.
-
- Momentan werden die folgenden Sprachen bzw. Compiler unterstützt:
- AmigaOberon, DICE C, M2Amiga Modula-2, MANX Aztec C and SAS C.
-
-
- Das Scripts Verzeichnis
- ========================
-
- Dieses Verzeichnis enthält eine Sammlung von ARexx- und
- Shell-Skripten, die in ToolManager Programmobjekten benutzt werden
- können. Beachen Sie, daß diese Skriptdateien an Ihre persönliche
- Arbeitsumgebung oder Shell angepasst werden müssen.
-
-
- Das Source Verzeichnis
- =======================
-
- Dieses Verzeichnis enthält den kompletten Quelltext zu ToolManager
- 2.1 und seinen Hilfsprogrammen. Jedes Programm hat sein eigenes
- Unterverzeichnis. Der Autor stellt den Quelltext als Beispiel für die
- Programmierung unter OS 2.x/3.0 zur Verfügung.
-
- Das Unterverzeichnis `locale' ist für Übersetzer interessant.
- Falls Ihre Sprache in dieser Version nicht unterstützt wird und Sie
- eine Übersetzung machen möchten, dann sollten Sie sich die Datei
- `empty.ct' anschauen. Sie müssen nur die Leerzeilen füllen und die
- Datei zu mir senden. Die Übersetzung wird dann eventuell in der
- nächsten Version enthalten sein.
-
-
- Das WBStartup Verzeichnis
- ==========================
-
- Dieses Verzeichnis enthält nur ein Programm: `ToolManager'. Dieses
- Hilfsprogramm startet und stoppt ToolManager 2.1. Meistens wird dieses
- Programm in das Verzeichnis `SYS:WBStartup' kopiert, aber man kann es
- auch von der Shell aus benutzen.
-
-
- Beschreibung der ToolManager-Objekte
- *************************************
-
- Dieses Kapitel beschreibt die ToolManager-Objekte im einzelnen.
- Jedes Objekt hat einen Typ und einen Namen. Der Name wird benutzt, um
- das Objekt anzusprechen. Es gibt sechs verschiedene Typen von Objekten:
-
-
- Programmobjekte
- ================
-
- Programmobjekte beschreiben Programme oder Aktionen, die von
- ToolManager gestartet werden sollen. Es werden drei verschiedene Typen
- von Programmen unterstützt: CLI, Workbench und ARexx. Drei
- verschiedene Typen von Aktionen werden unterstützt: Dock, Hot Key und
- Network. Jedes Programmobjekt hat die folgenden Parameter. Die
- Vorgabewerte sind in Klammern gesetzt:
-
- `Aktuelles Verzeichnis' (`SYS:')
- Der Name des aktuellen Verzeichnisses für das Programm.
- ARexx-Programme ignorieren diesen Parameter.
-
- `Argumente' (Ja)
- Dieser Schalter kontrolliert die Argumentübergabe an das
- Programm. Falls ein Programm keine Argumente annimmt oder sie
- nicht benötigt, dann können Sie hiermit die Argumentübergabe
- abschalten.
-
- `Ausgabedatei' (`NIL:')
- Der Dateiname für die Ausgabedatei. Dieser Parameter ist nur
- sinnvoll für CLI Programme.
-
- `Befehl'
- Der Dateiname für das zu startende Programm oder die
- auszuführende Aktion. Der Name kann relativ zum aktuellen
- Verzeichnis sein. Für die Aktion Dock bezeichnet dies den Namen
- des Dock-Objekts, das geöffnet/geschlossen werden soll. Für die
- Aktion Hot Key muß dieser Parameter auf einen gültigen
- Commodities Input Description String gesetzt sein (siehe
- Tastenbefehle). Ein Befehl für einen anderen ToolManager (Aktion
- Network) wird als `Objekt@Maschine' angegeben, d.h. der
- ToolManager, der auf `Maschine' läuft, soll das Programmobjekt
- mit dem Namen `Objekt' ausführen.
-
- `Befehlspfad' (Pfad des ToolManager-Prozesses)
- Dieser Parameter setzt den Befehlspfad für das Programm. Es
- können mehrere Verzeichnisse angegeben werden in dem man sie mit
- ";" trennt. Dieser Parameter ist nur sinnvoll für CLI Programme.
-
- `Nach vorne' (Nein)
- Wenn dieser Parameter gesetzt ist, dann wird der mit `Öffentlicher
- Schirm' angegebene öffentliche Schirm nach vorne geholt, bevor
- das Programm gestartet wird.
-
- `Öffentlicher Schirm' (Default)
- Sie können mit diesem Parameter angeben, welcher öffentlicher
- Schirm nach vorne geholt werden soll, bevor das Programm gestartet
- wird. Dieser Parameter funktioniert nur im Zusammenhang mit `Nach
- vorne'.
-
- `Priorität' (0)
- Dieser Parameter setzt die Priorität des neuen Prozesses, in dem
- das Programm läuft.
-
- `Programmtyp' (CLI)
- Dies gibt den Typ des Programmes oder der Aktion an. Es kann einer
- der sechs folgenden Typen angegeben werden: CLI, WB, ARexx, Dock,
- Hot Key oder Network.
-
- `Stack' (4096)
- Dieser Parameter setzt die Stackgröße des neuen Prozesses, in
- dem das Programm läuft.
-
- `Tastenbefehl'
- Sie können für jedes Programmobjekt einen Tastenbefehl angeben.
- Wenn Sie diesen Tastenbefehl benutzen wird das Programm gestartet.
- Beachten Sie: Das Programm wird ohne Argumente gestartet.
-
- `Verzögerung' (0)
- Nach der Aktivierung eines Programmobjekts wartet ToolManager
- `Verzögerung' Sekunden bevor er das Programm startet. Wenn dieser
- Wert negativ ist, dann wird das Programm alle `Verzögerung'
- Sekunden gestartet. Falls Sie ein Programmobjekt stoppen wollen,
- das auf die Ausführung wartet, aktivieren Sie es einfach noch
- einmal. Beachten Sie: Wenn `Verzögerung' gesetzt ist, dann wird
- das Programm ohne Argumente gestartet.
-
-
- Bildobjekte
- ============
-
- Bildobjekte geben die Bilddaten an, die von ToolManager für
- Piktogramme und Dock-Fenster benutzt werden. Dieser Objekttyp hat nur
- einen Parameter:
-
- `Dateiname'
- Dieser Parameter gibt den Namen der Datei an, aus der ToolManager
- die Bilddaten lesen soll. ToolManager versucht den Typ der
- Bilddaten automatisch zu erkennen:
-
- 1. Er versucht die Daten als IFF Daten zu laden. Momentan kann
- ToolManager ILBM (ein Bild) oder ANIM (zwei oder mehr Bilder)
- Dateien lesen.
-
- 2. Er versucht die Datei als Piktogrammdatei zu lesen. Ein
- Piktogramm kann ein oder zwei Bilder enthalten.
-
- Animation werden momentan nur von Dock-Objekten unterstützt.
- Piktogrammobjekte entnehmen momentan nur das erste und das zweite Bild
- einer Animation um ein Piktogramm aus 2 Bildern zu erstellen. Wenn Sie
- eine Animation für ToolManager erstellen wollen, dann sollten Sie sich
- an folgende Regeln halten:
-
- Bild 1
- Dieses Bild sollte den inaktiven Zustand repräsentieren.
-
- Bild 2
- Dieses Bild sollte den selektierten Zustand repräsentieren.
- Normalerweise ist es eine invertierte Kopie des ersten Bildes.
-
- Bild 3 bis N-1
- Dies sind die Bilder der eigentlichen Animation. Jedes Bild wird
- für eine 1/3 Sekunde angezeigt.
-
- Bild N
- Das letzte Bild der Animation wird für eine Sekunde angezeigt.
- Danach wird wieder das erste Bild angezeigt.
-
-
- Tonobjekte
- ===========
-
- Ein Tonobjekt wird benutzt, wenn ToolManager laut werden soll.
- ToolManager hat selber keinen eingebauten Spieler für digitalisierte
- Geräusche. Er benutzt ARexx, um einen externen Geräuscheabspieler
- anzusteuern. Dieser Objekttyp hat zwei Parameter:
-
- `Befehl'
- Dieser Parameter gibt den ARexx-Befehl an, den ToolManager an den
- externen Geräuscheabspieler senden soll. Für `upd' könnte dies
- etwas ähnliches wie `file samples:boing' sein, was `upd' anweist
- die IFF Datei `samples:boing' abzuspielen. Siehe Goodies.
-
- `ARexx-Port'
- Dieser Parameter gibt den Namen des ARexx-Ports an, an den
- ToolManager `Befehl' senden soll. Der voreingestellte Name ist
- `PLAY', der Name für das Programm `upd'.
-
-
- Menüobjekte
- ============
-
- Menüobjekte erzeugen Menüeinträge im Workbench `Hilfsmittel'
- Menü. Der Objektname wird benutzt als Menütext. Um ein solches Objekt
- zu aktivieren müssen Sie einfach den entsprechenden Menüeintrag
- selektieren. Menüobjekte sind nur verfügbar wenn die Workbench läuft.
-
- Dieser Objekttyp hat zwei Parameter:
-
- `Programmobjekt'
- Dies ist der Name eines Programmobjektes, das aktiviert werden
- soll, wenn der Menüeintrag selektiert wurde. Jedes Piktogramm,
- das zu diesem Zeitpunkt ausgewählt ist, wird als Argument für
- das Programm benutzt.
-
- `Tonobjekt'
- Dies ist der Name eines Tonobjekts, das aktiviert werden soll,
- wenn der Menüeintrag selektiert wurde.
-
- ToolManager 1.X Benutzer: Wenn Sie den alten Tooltyp "Dummy"
- simulieren wollen, dann erzeugen Sie einfach eine Menüobjekt und geben
- *kein* Programm- oder Tonobjekt an.
-
-
- Piktogrammobjekte
- ==================
-
- Piktogrammobjekte beschreiben Applikationspiktogramme im
- Workbench-Fenster. Solch ein Objekt kann aktiviert werden durch
- Doppelklicken des Piktogramms oder indem einige Piktogramme auf das
- Applikationspiktogramm geschoben werden. Piktogrammobjekte sind nur
- verfügbar wenn die Workbench läuft.
-
- Die Parameter für diesen Objekttyp sind wie folgt:
-
- `Bildobjekt'
- Dies ist der Name eines Bildobjekts. Die Bilddaten dieses Objektes
- werden dazu benutzt das Applikationspiktogramm zu erstellen.
-
- `Linke Kante' (Vorgabe: 0)
- Dies setzt die linke Kante für das Applikationspiktogramm.
-
- `Obere Kante' (Vorgabe: 0)
- Dies setzt die obere Kante für das Applikationspiktogramm.
-
- `Programmobjekt'
- Dies ist der Name eines Programmobjektes, das aktiviert werden
- soll wenn das Piktogramm selektiert wurde. Jedes Piktogramm, das
- auf das Applikationspiktogramm geschoben wurde, wird als Argument
- für das Programm benutzt.
-
- `Tonobjekt'
- Dies ist der Name eines Tonobjekts, das aktiviert werden soll wenn
- das Piktogramm selektiertiert wurde.
-
- `Zeige Namen' (Vorgabe: Ja)
- Wenn dieser Parameter gesetzt ist, dann wird der Objektname als
- Namen für das Applikationspiktogramm benutzt.
-
- Die Workbench ist *sehr* eigensinnig mit Piktogrammpositionen. Wenn
- Sie eine Position gewählt haben, die der Workbench nicht zusagen, dann
- ignoriert sie sie einfach und legt das Piktogramm irgendwo anders hin.
-
-
- Dock-Objekte
- =============
-
- Dock-Objekte beschreiben Fenster. Diese Fenster fassen mehrere
- Programme zusammen, welche durch Bilder oder Textgadgets repräsentiert
- werden. Um ein Programm zu starten, braucht man nur auf das Bild oder
- das Textgadget zu klicken. Natürlich können auch Piktogramme auf das
- Bild oder das Textgadget geschoben werden, um das Programm mit
- Argumenten zu versorgen.
-
- Jedes Dock-Objekt hat die folgenden Parameter. Die Vorgaben sind in
- Klammern gesetzt:
-
- `Aktiviert' (Ja)
- Ein Dock-Fenster kann aktiv (offen) oder nicht aktiv (geschlossen)
- sein.
-
- `Backdrop' (Nein)
- Wenn dieser Parameter gesetzt ist, dann setzt sich das
- Dock-Fenster nach dem Öffnen sofort in den Hintergrund.
-
- `Fensternamen'
- Dieser Parameter setzt den Namen des Dock-Fensters. Wenn Sie einen
- Fensternamen angeben, dann öffnet sich eine normales OS 2.0
- Fenster mit Dragbar, Close-Gadget, Depth-Gadget und einem Rand.
- Wenn Sie *keinen* Namen angeben, dann öffnet sich ein Fenster,
- das keinen Rahmen und nur einen Dragbar hat.
-
- `Linke Kante' (0)
- Linke Kante des Dock-Fensters. Dieser Parameter wird ignoriert,
- wenn der Parameter `Zentriert' gesetzt ist.
-
- `Menü' (Nein)
- An jedes Dock-Fenster kann ein Menü angehängt werden. Dieses
- Menü hat zwei Einträge:
-
- * `Dock schliessen' Schliessen des Dock-Fensters.
-
- * `TM beenden' ToolManager beenden.
-
- `Muster' (Nein)
- Das Dock-Fenster richtet sich automatisch nach der Grösse des
- größten Bildes. Da jeder Eintrag die gleiche Grösse hat und
- kleinere Bilder zentriert werden, haben kleinere Bilder einen
- leeren Rand. Falls Sie diesen Rand nicht mögen, dann können Sie
- mit diesem Parameter ein Muster einschalten.
-
- `Obere Kante' (0)
- Obere Kante des Dock-Fensters. Dieser Parameter wird ignoriert,
- wenn der Parameter `Zentriert' gesetzt ist.
-
- `Öffentlicher Schirm' (Default)
- Dies gibt den öffentlichen Schirm an, auf dem das Dock-Fenster
- geöffnet werden soll. Wenn das Fenster mit Hilfe des
- Tastenbefehls geöffnet wurde, dann wird der öffentliche Schirm
- nach vorne geholt. Dieser Parameter wird ignoriert, wenn der
- Parameter `Vorderster' gesetzt ist.
-
- `PopUp' (Nein)
- Wenn dieser Parameter gesetzt ist, dann schliesst sich das
- Dock-Fenster automatisch, nachdem ein Eintrag ausgewählt wurde.
- Dieser Parameter ist besonders nützlich in Verbindung mit den
- Parametern `Vorderster', `Zentriert' und einem Tastenbefehl der
- Klasse `rawmouse' (siehe Tastenbefehle).
-
- `Spalte' (1)
- Dieser Parameter setzt die Anzahl der Spalten in dem Dock-Fenster.
- Die Einträge werden zeilenweise einsortiert, beginnend mit der
- linken Spalte und fortlaufend bis zur rechten Spalte.
-
- `Stationär' (Nein)
- Normalerweise merkt sich ein Dock-Fenster beim Schliessen seine
- letzte Position und öffnet sich an der gleichen Stelle wieder.
- Wenn das Dock-Fenster immer an der gleichen Position aufgehen
- soll, dann setzen Sie diesen Parameter.
-
- `Tastenbefehl'
- Sie können für jedes Dock-Objekt einen Tastenbefehl angeben.
- Wenn Sie diesen Tastenbefehl benutzen, dann wird der Status des
- Dock-Fensters umgeschaltet, d.h. es wird geöffnet oder
- geschlossen.
-
- `Text' (Nein)
- Mit diesem Parameter können Sie zwischen Bildern und Textgadgets
- in Dock-Fenstern wählen. Dock-Fenster mit Textgadgets sind
- besonders nützlich in Verbindung mit dem Parameter `PopUp'.
-
- `Vertikal' (Nein)
- Dieser Parameter setzt die Richtung der Dragbar. Dieser Parameter
- wird ignoriert, wenn Sie einen Fensternamen mit dem Parameter
- `Fensternamen' angegeben haben.
-
- `Vorderster' (Nein)
- Wenn dieser Parameter gesetzt ist, dann öffnet sich das
- Dock-Fenster immer auf dem vordersten öffentlichen Schirm.
-
- `Zeichensatz' (Zeichensatz des Schirms)
- Wenn in einem Dock-Objekt der Parameter `Text' gesetzt ist, dann
- kann mit diesem Parameter der Zeichensatz für die Textgadgets
- gewählt werden.
-
- `Zentriert' (Nein)
- Wenn dieser Parameter gesetzt ist, dann wird das Dock-Fenster
- immer zentriert zur aktuellen Mausposition geöffnet.
-
-
- Zugriffsobjekte
- ================
-
- Zugriffsobjekte kontrollieren die Zugriffsrechte für Anfragen über
- Netzwerke. Grundsätzlich wird *jede* Anfrage abgelehnt, so daß ein
- anderer ToolManager nicht die Arbeit Ihrer Maschine durch Aktivierung
- von Programmobjekten stören kann. Mit Zugriffsobjekten jedoch können
- sie es einzelnen Maschinen erlauben, einige Programmobjekte von Ihrem
- ToolManager auszuführen.
-
- Der Name eines Zugriffsobjekt hat dabei eine spezielle Bedeutung. Er
- wird mit dem Namen der Maschine verglichen, von dem die Anfrage stammt.
- Dabei benutzt ToolManager das folgende dreistufige Vergleichsschema:
-
- 1. Vergleiche mit dem kompletten Maschinennamen
-
- 2. Vergleiche mit dem Bereichsnamen
-
- 3. Suche nach einem Zugriffsobjekt mit dem Namen `anyone'
-
- Wenn das entsprechende Objekt gefunden wurde, dann gibt dieses
- Objekt die Zugriffsrechte der anderen Maschine an. Das Objekt mit dem
- Namen `anyone' wird für jede Netzwerkanfrage benutzt, für die kein
- Zugriffsobjekt gefunden werden kann.
-
- Zugriffsobjekte haben nur einen Parameter:
-
- `Programmobjekt'
- Dieser Parameter kann mehrfach benutzt werden und gibt die
- Programmobjekte an, die von der anderen Maschine aktiviert werden
- können. Wenn Sie *keinen* Objektnamen angeben, dann kann die
- andere Maschine *alle* Programmobjekte auf Ihrer Maschine
- aktivieren.
-
-
- Der Voreinsteller für ToolManager
- **********************************
-
- Mit dem Voreinsteller können Sie die globale Konfiguration von
- ToolManager manipulieren. Diese Konfiguration wird automatisch beim
- Start von ToolManager geladen. Um den Voreinsteller zu starten, müssen
- Sie sein Piktogramm doppelklicken. Danach öffnet sich das Hauptfenster.
-
- Die meisten Gadgets in den Voreinstellerfenstern haben einen
- Tastenkürzel. Sie sind mit einem Unterstrich (`_') markiert. Beachten
- Sie allerdings, daß Sie bei einem aktiven Zeichenketten-Gadget erst
- die Return-Taste betätigen müssen, bevor Sie das Tastenkürzel
- benutzen können.
-
-
- Gadgets im Hauptfenster
- ========================
-
- Das Hauptfenster hat mehrere Gruppen von Gadgets:
-
- Objekttyp
- Mit diesem zyklischem Auswahlgadget kann der Typ der Objekte
- gewählt werden, die Sie erzeugen oder ändern wollen.
-
- Objektliste
- Dieses Gadget zeigt die Liste aller Objekte des aktuellen Typs an.
- Sie können ein Objekt auswählen indem sie auf seinen Namen
- klicken. Wenn sie einen Eintrag doppelklicken, dann öffnet sich
- das Objektfenster.
-
- Objekt verschieben
- Wenn ein Objekt ausgewählt worden ist, dann kann es mit diesen
- Gadgets in der Liste verschoben werden. Das `Sortieren' Gadget
- dient dazu, die Liste alphabetisch zu sortieren.
-
- Objekt manipulieren
- Diese Gadgets manipulieren Objekte. Das `Neu' Gadget erzeugt ein
- neues Gadget vom aktuellen Typ. Dieses neue Objekt wird
- automatisch selektiert. Das `Ändern' Gadget öffnet das
- Objektfenster. Mit dem `Kopieren' Gadget kann man eine Kopie des
- selektierten Objektes erstellen. Das `Entfernen' Gadget löscht
- das selektierte Objekt.
-
- Konfiguration
- Sie haben mehrere Möglichkeiten die Konfiguration zu speichern.
- Mit dem `Speichern' Gadget wird die Konfiguration permanent in der
- Datei `ENVARC:ToolManager.prefs' gespeichert. Für eine temporäre
- Änderung kann die Konfiguration mit dem `Benutzen' Gadget in der
- Datei `ENV:ToolManager.prefs' abgespeichert werden. Diese Datei
- wird bei einem Reset gelöscht. Wenn Sie eine Konfiguration testen
- wollen, ohne den Voreinsteller zu verlassen, dann benutzen Sie das
- `Testen' Gadget. Mit dem `Abbrechen' Gadget können Sie den
- Voreinsteller ohne Abspeichern verlassen.
-
-
- Menüs des Hauptfensters
- ========================
-
- Das Hauptfenster hat mehrere Menüs:
-
- `Project'
- Mit den Menüeinträgen `öffnen' und `speichern als' können Sie
- die Konfiguration laden und speichern. Der `Information' Eintrag
- öffnet einen Informationsrequester. Mit dem Eintrag `beenden' kann
- man den Voreinsteller ohne Abspeichern verlassen.
-
- `Vorgaben'
- Mit den zwei Menüeinträgen können ältere Konfigurationen
- wiederhergestellt werden. Der Eintrag `auf zuletzt gespeichertes'
- lädt die Konfiguration aus der Datei `ENVARC:ToolManager.prefs'.
- Mit dem Eintrag `auf vorherigen Stand' wird diejenige
- Konfiguration, die vor dem Start des Voreinstellers gültig war,
- aus der Datei `ENV:ToolManager.prefs' geladen.
-
- `Optionen'
- Mit dem Eintrag `Piktogramme erzeugen?' können Sie vorgeben, ob
- der Eintrag `speichern als' ein Piktogramm erzeugen soll oder
- nicht.
-
-
- Erzeuge Objekte Fenster
- ========================
-
- Wenn Sie ein Piktogramm auf das Hauptfenster legen, dann erscheint
- das "Erzeuge Objekte" Fenster. In diesem Fenster können sie
- auswählen, wie das Piktogramm verarbeitet werden soll. Dies können Sie
- benutzen, um ein Program einfach und schnell zu Ihre Konfiguration
- hinzuzufügen.
-
- Sie können entweder nur ein Programm- oder Bildobjekt aus dem
- Piktogramm erzeugen, in dem Sie einen der ersten beiden Punkte
- auswählen. Sie können aber auch ein komplettes Menü- und/oder
- Piktogrammobjekt erzeugen, in dem Sie einen der drei letzten Punkte
- auswählen.
-
-
- Objektfenster
- ==============
-
- Jeder Objekttyp hat ein eigenes Objektfenster, in dem man die
- Objektparameter setzen kann. Für eine detailierte Liste aller
- Parameter siehe Objekte.
-
- Jedes Objektfenster hat ein Gadget für den Objektnamen. Dieser Name
- ist wichtig, da er dazu benutzt wird das Objekt anzusprechen. Beachten
- Sie, daß es keine Querverweise gibt, d.h. wenn Sie den Namen eines
- Objektes ändern, das schon von einem anderen Objekt verwendet wird, so
- wird der Verweis in diesem Objekt *nicht* aktualisiert. Sie müssen
- diesen Verweis per Hand aktualisieren.
-
- Die Tastengadgets in den Objektfenstern öffnen verschiedene
- Requester. Sie können einen Eintrag auswählen, indem sie den Namen
- und das `Benutzen' Gadget anklicken oder indem sie den Namen
- doppelklicken. Um einen Requester ohne Änderungen zu verlassen,
- benutzen Sie das `Abbrechen' Gadget. Wenn sie ein Feld löschen wollen,
- das nur mit einem Requester ausgewählt werden kann, dann öffnen Sie
- den Requester und klicken das `Benutzen' Gadget *ohne* vorher einen
- Eintrag auszuwählen.
-
- Die Objekfenster für Programm- und Bildobjekte haben ein
- zusätzliches Merkmal. Sie können ein Piktogramm auf diese Fenster
- schieben und die Parameter werden aus diesem Piktogramm entnommen.
-
-
- Tooltypes
- ==========
-
- Wenn Sie den Voreinsteller von der Workbench starten, dann können
- Sie in den Piktogrammen für das Programm oder den
- Konfigurationsdateien verschiedene Tooltypes setzen, um den
- Voreinsteller zu kontrollieren.
-
- `USE'
- Wenn Sie diesen Tooltype in einem Piktogramm für eine
- Konfigurationsdatei setzen, dann installiert der Voreinsteller
- diese Datei als aktuelle Konfiguration.
-
- `SAVE'
- Wenn Sie diesen Tooltype in einem Piktogramm für eine
- Konfigurationsdatei setzen, dann installiert der Voreinsteller
- diese Datei als aktuelle und permanente Konfiguration.
-
- `PUBSCREEN'
- Dieser Tooltype gibt den Namen des öffentlichen Schirms an, auf
- dem der Voreinsteller seine Fenster öffnen soll.
-
- `CREATEICONS'
- Wenn dieser Tooltype auf `YES' gesetzt wird, dann erzeugt der
- Voreinsteller für jede Konfigurationsdatei, die mit dem
- Menüeintrag `speichern als' erzeugt wird, ein Piktogramm.
-
- `DEFAULTFONT'
- Normalerweise benutzt der Voreinsteller den Zeichensatz des
- öffentlichen Schirms um seine Gadgets zu erzeugen. Wenn Sie diesen
- Tooltype auf `YES' setzen, dann benutzt der Voreinsteller den
- Standard Systemzeichensatz.
-
- `XPOS'
- Dies gibt die X Position des Hauptfensters an.
-
- `YPOS'
- Dies gibt die Y Position des Hauptfensters an.
-
- `MINLISTCOLUMNS'
- Dies gibt die minimale Anzahl der Spalten in den Listen-Gadgets an.
-
- `MINLISTROWS'
- Dies gibt die minimale Anzahl der Reihen in den Listen-Gadgets an.
-
-
- CLI Argumente
- ==============
-
- Wenn der Voreinsteller von der Shell gestartet wird, dann benutzt er
- folgende Schablone für die Kommandozeile:
-
- FROM,EDIT/S,USE/S,SAVE/S,PUBSCREEN/K,DEFAULTFONT/S
-
- `FROM'
- Dieser Parameter gibt an, welche Konfigurationsdatei der
- Voreinsteller laden soll.
-
- `USE'
- Wenn Sie diesen Parameter benutzen, dann installiert der
- Voreinsteller die Datei, die mit dem `FROM' Parameter angegeben
- wurde, als aktuelle Konfiguration.
-
- `SAVE'
- Wenn Sie diesen Parameter benutzen, dann installiert der
- Voreinsteller die Datei, die mit dem `FROM' Parameter angegeben
- wurde, als aktuelle und permante Konfiguration.
-
- `PUBSCREEN'
- Dieser Parameter gibt den Namen des öffentlichen Schirms an, auf
- dem der Voreinsteller seine Fenster öffnen soll.
-
- `DEFAULTFONT'
- Normalerweise benutzt der Voreinsteller den Zeichensatz des
- öffentlichen Schirms um seine Gadgets zu erzeugen. Wenn Sie diesen
- Parameter angeben, dann benutzt der Voreinsteller den Standard
- Systemzeichensatz.
-
-
- Die ToolManager shared library Schnittstelle
- *********************************************
-
- Der ToolManager-Handler ist in eine Amiga shared library
- eingebettet. Diese Library bietet mehrere Funktionen an, um
- ToolManager-Objekte zu erzeugen und zu manipulieren, so daß Sie sie
- von Ihren Programmen aus benutzen können.
-
- Momentan sind 6 Funktionen vorhanden:
-
- `AllocTMHandle()'
- Damit Sie ToolManager-Objekte erzeugen können, müssen Sie zuerst
- einen TMHandle allozieren. Diese Datenstruktur speichert alle
- Informationen über Ihre Objekte und sie wird dazu benutzt Ihre
- Objekte anzusprechen. Beachten Sie, daß die Information, die in
- dieser Datenstruktur gespeichert ist, *nur* dem Programm
- zugänglich ist, das den TMHandle erzeugt hat.
-
- `FreeTMHandle()'
- Diese Funktion gibt einen TMHandle und alle mit ihm verbundenen
- ToolManager-Objekte frei. Jeder `AllocTMHandle()' Aufruf muß mit
- einem `FreeTMHandle()' Aufruf gepaart sein!
-
- `CreateTMObjectTags()'
- `CreateTMObjectTagList()'
- Diese Funktion erzeugt ein ToolManager-Objekt. Sie müssen einen
- Namen, den Objekttyp und verschiedene Tags für die
- Objektparameter angeben. Der Name des Objekts ist wichtig, da er
- dazu benutzt wird, das Objekt anzusprechen.
-
- `ChangeTMObjectTags()'
- `ChangeTMObjectTagList()'
- Sie können die Parameter eines ToolManager-Objekts mit dieser
- Funktion verändern. Beachten Sie, daß Bildobjekte momentan nicht
- geändert werden können.
-
- `DeleteTMObject()'
- Diese Funktion löscht ein ToolManager-Objekt. Falls andere
- Objekte auf dieses Objekt verweisen, dann werden diese
- benachrichtigt, damit sie ihren Status erneuern könen.
-
- `QuitToolManager()'
- Diese Funktion teilt dem ToolManager-Handler mit, daß er so bald
- wie möglich stoppen sollte.
-
- Die komplette Library Schnittstellenbeschreibung ist im
- AutoDoc-Format vorhanden (siehe Docs).
-
-
- Wie man einen Tastenbefehl definiert
- *************************************
-
- Diese Kapitel beschreibt wie man einen Tastenbefehl als einen Input
- Description String definiert, der dann von Commodities ausgewertet
- werden kann. Jedes Mal, wenn ein Tastenbefehl ausgeführt wird, erzeugt
- Commodities eine Ereignis, das dann von ToolManager dazu benutzt wird
- Programmobjekte zu aktivieren oder Dock-Objekte umzuschalten. Ein
- Description String hat die folgende Syntax:
-
- [<Klasse>] {[-][<Qualifier>]} [-][upstroke] [<Tastenkode>]
-
- Alle Befehlsworte können groß oder klein geschrieben werden.
-
- `Klasse' beschreibt die InputEvent-Klasse. Dieser Parameter ist
- optional und falls er weggelassen wird, dann wird die Vorgabe `rawkey'
- benutzt. Siehe InputEvent-Klassen.
-
- Qualifier sind "Signale", die gesetzt oder nicht gesetzt sein
- müssen zu dem Zeitpunkt, an dem der Tastenbefehl ausgeführt wird,
- sonst wird kein Ereignis erzeugt. Für jeden Qualifier, der gesetzt
- sein soll, müssen Sie das Befehlswort angeben. Alle anderen Qualifier
- müssen dann nicht gesetzt sein. Falls Sie einen Qualifier ignorieren
- wollen, dann setzen sie ein `-' vor sein Befehlswort. Siehe Qualifier.
-
- Normalerweise wird ein Ereignis erzeugt, wenn eine Taste gedrückt
- wird. Falls das Ereignis generiert werden soll wenn die Taste
- losgelassen wird, dann müssen Sie das Befehlswort `upstroke' angeben.
- Wenn sowohl beim Drücken als auch beim Loslassen der Taste ein
- Ereignis erzeugt werden soll, dann müssen sie das Befehlswort
- `-upstroke' angeben.
-
- Der Tastenkode ist abhängig von der InputEvent-Klasse. Siehe
- Tastenkodes.
-
- Achtung: Wählen Sie ihre Tastenbefehle *sorgfältig*, denn
- Commodities hat eine hohe Priorität in der InputEvent-Handlerkette,
- d.h. vorgegebene Definitionen werden übergangen.
-
-
- InputEvent-Klassen
- ===================
-
- Commodities unterstützt die meisten der InputEvent-Klassen, die von
- dem input.device erzeugt werden. Diese Sektion beschreibt die Klassen,
- die nützlich für ToolManager sind.
-
- `rawkey'
- Dies ist die vorgegebene Klasse. Sie beschreibt alle Ereignisse,
- die durch die Tastatur erzeugt werden können. Zum Beispiel
- erzeugt `rawkey a' oder `a' jedesmal ein Ereignis, wenn die Taste
- "a" gedrückt wird. Sie müssen einen Tastenkode für diese Klasse
- angeben. Siehe rawkey Tastenkodes.
-
- `rawmouse'
- Diese Klasse beschreibt alle Ereignisse, die durch die Maus
- erzeugt werden können. Sie müssen einen Tastenkode für diese
- Klasse angeben. Siehe rawmouse Tastenkodes.
-
- `diskinserted'
- Ereignisse dieser Klasse werden generiert, wenn eine Diskette in
- ein Laufwerk gelegt wird. Diese Klasse besitzt keine Tastenkodes.
-
- `diskremoved'
- Ereignisse dieser Klasse werden generiert, wenn eine Diskette aus
- einem Laufwerk genommen wird. Diese Klasse besitzt keine
- Tastenkodes.
-
-
- Qualifier
- ==========
-
- Einige Befehlsworte wurden erst bei Commodities V38 eingeführt.
- Diese sind mit einem `*' markiert.
-
- `lshift', `left_shift' *
- Linke Shift-Taste.
-
- `rshift', `right_shift' *
- Rechte Shift-Taste.
-
- `shift'
- Irgendeine Shift-Taste.
-
- `capslock', `caps_lock' *
- Caps-Lock-Taste.
-
- `caps'
- Irgendeine Shift-Taste oder die Caps-Lock-Taste.
-
- `control', `ctrl' *
- Control-Taste.
-
- `lalt', `left_alt' *
- Linke Alt-Taste.
-
- `ralt', `right_alt' *
- Rechte Alt-Taste.
-
- `alt'
- Irgendeine Alt-Taste.
-
- `lcommand', `lamiga' *, `left_amiga' *, `left_command' *
- Linke Amiga-/Kommando-Taste.
-
- `rcommand', `ramiga' *, `right_amiga' *, `right_command' *
- Rechte Amiga-/Kommando-Taste.
-
- `numericpad', `numpad' *, `num_pad' *, `numeric_pad' *
- Dieses Befehlswort *muß* angegeben werden, wenn eine Taste von der
- Zehnertastatur benutzt wird.
-
- `leftbutton', `lbutton' *, `left_button' *
- Linke Maustaste. Siehe unten.
-
- `midbutton', `mbutton' *, `middlebutton' *, `middle_button' *
- Mittlere Maustaste. Siehe unten.
-
- `rbutton', `rightbutton' *, `right_button' *
- Rechte Maustaste. Siehe unten.
-
- `repeat'
- Dieser Qualifier ist gesetzt, wenn die Tastenwiederholung aktiv
- ist. Dies ist nur sinnvoll für die InputEvent-Klasse `rawkey'.
-
- Achtung: Commodities V37 hat einen Fehler, der die Benutzung von
- `leftbutton', `midbutton' und `rbutton' als Qualifier verhindert.
- Dieser Fehler wurde in V38 behoben.
-
-
- Tastenkodes
- ============
-
- Jede InputEvent-Klasse besitzt ihre eigenen Tastenkodes:
-
-
- Tastenkodes für die InputEvent-Klasse `rawkey'
- -----------------------------------------------
-
- Einige Befehlsworte wurden erst bei Commodities V38 eingeführt.
- Diese sind mit einem `*' markiert.
-
- `a'-`z', `0'-`9', ...
- ASCII-Zeichen.
-
- `f1', `f2', ..., `f10', `f11' *, `f12' *
- Funktionstasten.
-
- `up', `cursor_up' *, `down', `cursor_down' *
- `left', `cursor_left' *, `right', `cursor_right' *
- Cursor-Tasten.
-
- `esc', `escape' *, `backspace', `del', `help'
- `tab', `comma', `return', `space', `spacebar' *
- Spezial-Tasten.
-
- `enter', `insert' *, `delete' *
- `page_up' *, `page_down' *, `home' *, `end' *
- Tasten der Zehnertastatur. Diese Tastenkodes *müssen* mit dem
- Qualifier `numericpad' benutzt werden!
-
-
- Tastenkodes für die InputEvent-Klasse `rawmouse'
- -------------------------------------------------
-
- Diese Befehlsworte wurden erst bei Commodities V38 eingeführt. Sie
- sind nicht verfügbar in V37.
-
- `mouse_leftpress'
- Drücke die linke Maustaste.
-
- `mouse_middlepress'
- Drücke die mittlere Maustaste.
-
- `mouse_rightpress'
- Drücke die rechte Maustaste.
-
- Achtung: Um einen dieser Tastenkodes zu benutzen, müssen sie auch
- das entsprechende Qualifier-Befehlswort angeben, z.B.
-
- rawmouse leftbutton mouse_leftpress
-
-
- Beispiele für Tastenbefehle
- ============================
-
- `ralt t'
- Rechte Alt-Taste festhalten und "t" drücken.
-
- `ralt lalt t'
- Rechte *und* linke Alt-Taste festhalten und "t" drücken.
-
- `alt t'
- Irgendeine Alt-Taste festhalten und "t" drücken.
-
- `rcommand f2'
- Rechte Amiga-Taste festhalten und die zweite Funktionstaste
- drücken.
-
- `numericpad enter'
- Enter-Taste auf der Zehnertastatur drücken.
-
- `rawmouse midbutton leftbutton mouse_leftpress'
- Mittlere Maustaste festhalten und die linke Maustaste drücken.
-
- `diskinserted'
- Eine Diskette in ein Laufwerk einlegen.
-
-
- Die häufigsten Fragen zum ToolManager
- **************************************
-
- Hier sind die Antworten für die am häufigsten gestellten Fragen zum
- ToolManager:
-
- - Warum kann ToolManager keine mehrfachen Menüs oder Untermenüs
- erstellen?
-
- Mehrfache Menüs oder Untermenüs werden zur Zeit noch nicht vom
- Betriebssystem unterstützt. Um sie zu erzeugen, muß man sie in
- das System *patchen*, was zu einem instabilen System führen kann.
- Da ich keine unstabile Software schreiben möchte, werde ich so
- etwas nicht in ToolManager einbauen.
-
- - WB-Programme starten nicht, aber alles andere funktioniert.
-
- ToolManager benötigt das Programm `L:WBStart-Handler', um
- WB-Programme starten zu können. Es gibt zwei Möglichkeiten,
- warum ToolManager diese Programm nicht ausführen kann:
-
- * Die Datei `L:WBStart-Handler' existiert nicht. Bitte kopieren
- Sie diese Datei aus der Distribution nach `L:'.
-
- * Die Execute-Flagge (e) ist bei dieser Datei nicht gesetzt.
- Benutzen Sie das folgende Kommando, um diese Flagge zu
- setzen: `protect L:WBStart-Handler +e'
-
- - Wie kann ich ein horizontales Dock-Fenster erzeugen?
-
- Setzen Sie die Anzahl der Spalten gleich der Anzahl der Einträge
- in dem Dock-Objekt.
-
- - Wie kann ich ein Ausgabefenster für CLI-Programme erzeugen?
-
- Ausgabefenster können mit Hilfe des `CON:' Geräts erzeugt
- werden. Benutzen Sie den folgenden Dateinamen, um ein sich
- automatisch öffnendes Fenster mit einem Close-Gadget zu erzeugen,
- das nach dem Ende des Programmes sich nicht automatisch schliesst:
-
- CON:10/10/640/100/Ausgabefenster/AUTO/CLOSE/WAIT
-
- Das Gerät `CON:' hat viele Optionen, die Sie dem AmigaDOS Handbuch
- entnehmen können.
-
- - Wie kann ich die Argumente in die Mitte einer CLI/ARexx
- Kommandozeile einfügen?
-
- Normalerweise werden alle Argumente an die Kommandozeile
- angehängt. Um sie jedoch irgendwo in der Kommandozeile
- einzufügen, benutzt ToolManager die gleiche `[]' Syntax, wie der
- AmigaShell-Befehl `alias'. Dies sieht dann z.B. so aus:
-
- Dir [] all
-
- Alle Argumente werden vor dem Schlüsselwort `all' eingefügt.
-
- - Wie kann ich eine Referenz von einem komplexen Objekt zu einem
- einfachen Objekt löschen?
-
- Nachdem Sie das Gadget "xxxobjekt" gedrückt haben, müssen Sie
- das Gadget "Benutzen" drücken *ohne* vorher ein Objekt
- auszuwählen. Dies bedeutet, daß Sie kein Objekt ausgewählt haben
- und daher wird die Referenz gelöscht.
-
- - Wie kann ich Unter-Docks erzeugen?
-
- Sie müssen dafür Programmobjekte des Typs Dock verwenden. Setzen
- Sie solche Objekte in Ihr Haupt-Dock und sie werden dann die
- anderen Dock-Fenster öffnen bzw. schliessen.
-
- - ToolManager rührt sich nicht mehr, nachdem er eine Netzwerkanfrage
- erzeugt hat.
-
- Momentan gibt es ein Problem in der Software für Netzwerke:
- Lokale Anfragen werden bei Zeitüberschreitung nicht abgebrochen.
- Wenn Ihre Maschine nun `Maschine1' heißt und Sie ein
- Programmobjekt vom Typ Network mit dem Befehl `Objekt@Maschine1'
- haben, dann gerät ToolManager in eine Ausschluß-Situation, wenn
- Sie dieses Objekt aktivieren. Bitte benutzen Sie nur Namen von
- anderen Rechnern!
-
-
- Die Entwicklung von ToolManager
- ********************************
-
- 2.1, Datum 16.05.1993
- - Neue Programmobjekttypen: Dock, Hot Key, Network
-
- - Neue Dock-Objekt Parameter: Backdrop, Stationär
-
- - Neuer Objekttyp: Zugriff
-
- - Netzwerkunterstützung
-
- - Das Voreinsteller Hauptfenster ist jetzt ein AppWindow
-
- - Tastenkürzel für die Gadgets im Voreinsteller
-
- - Neue Tooltypes für den Voreinsteller
-
- - Mehrere Fehler beseitigt
-
- - Verbesserte Dokumentation
-
- 2.0, Datum 26.09.1992, Fish Disk #752
- - Komplett neues Konzept (objektorientiert)
-
- - (Fast) komplette Neuprogrammierung
-
- - ToolManager ist nun in zwei Teile aufgespalten
-
- - Der Handler ist in eine shared Library eingebettet
-
- - Die Konfiguration wird nun mit einem Voreinsteller bearbeitet
-
- - Das Konfigurationsdateiformat wurde wieder geändert :-) Es
- ist nun eine IFF Datei und liegt in ENV:
-
- - Mehrere Docks und Docks mit mehrere Spalten sind nun möglich
-
- - Es gibt Docks mit neuem Aussehen
-
- - Docks richten sich nun automatisch nach der Größe des
- größten Bildes
-
- - Sound Unterstützung
-
- - ARexx werden direkt in Programmobjekten unterstützt
-
- - ToolManager kann nun ohne Workbench benutzt werden. Wenn die
- Workbench nicht läuft, dann benutzt er keine App* Merkmale
- mehr.
-
- - Locale Unterstützung
-
- - Der Befehlspfad der Workbench wird für CLI Programme benutzt
-
- - Ein eigener Prozess startet die WB Programme
-
- 1.0 bis 1.5
- Die Bemerkungen zu diesen Versionen entnehmen Sie bitte der
- englischen Dokumentation.
-
-
- Der Autor möchte danken...
- ***************************
-
- ToolManager hat mehrere große Entwicklungsphasen seit seiner ersten
- Programmierung Mitte 1990 durchlebt. Diese Entwicklung wäre unmöglich
- gewesen, wenn ich nicht den enormen Feedback von einigen ToolManager
- Benutzern gehabt hätte. Viele Ideen & Merkmale stammen aus dieser
- Quelle...
-
- Daher möchte ich den folgenden Personen danken:
-
- Für die Alpha-/Beta-Tests, Ideen & Bug Reports:
- Die Amigagruppe unseres Computerclubs (Computerclub an der RWTH
- Aachen), Olaf 'Olsen' Barthel, Georg Hessmann (Gucky), Markus
- Illenseer (ill), Klaus Melchior, Rickard Olsson (Richie), Matthias
- Scheler (Tron), Ralph Schmidt (laire), Roger Westerlund (Budda),
- Juergen Weinelt, Brian Wright (SteveVai), Petra Zeidler
- (stargazer) und viele andere...
-
- Matthew Dillon
- Ohne dein *exzellentes* C Entwicklungssystem DICE und verschiedener
- anderer Hilfsprogramme würde es keinen ToolManager geben!
-
- Für ihre hervorragenden Grafiken:
- Andreas Harrenberg, Georg Hessmann, Michael "Mick" Hohmann, Markus
- Illenseer, Oliver Koenen, Klaus Melchior, Rickard Olsson, Jan
- Peter, Matthias Scheler, Brian Wright
-
- Für die Übersetzungen:
- Tomi Blinnikka (Finnisch), Dr. Peter Kittel (Deutsch), Klaus
- Melchior (Eifel Platt), Rickard Olsson (Schwedisch), Marc Schaefer
- (Französisch & Italienisch)
-
- Alle Leute in West Chester:
- Für die Entwicklung des Amigas und seines hervorragenden
- Betriebssystems.
-
- Alle Benutzer, die mir Geld geschickt haben:
- Ich habe in den 1.X Versionen nicht danach gefragt, aber es ist
- erfreulich, wenn jemand meine Arbeit so sehr schätzt.
-
- Alle Benutzer, die mir einen Brief geschickt haben:
- Ich habe es genossen, Eure Briefe zu lesen!
-
- und natürlich alle, die ich vergessen habe zu erwähnen...
-
- Index
- ******
-
-
-
- Übersetzer Source
- Übersetzungen Locale
- TeX Docs
- Adresse Adresse des Autors
- AmigaGuide Docs
- Antworten Fragen
- ARexx-Skripte Scripts
- ASCII Dokumentation Docs
- Beispielbilder Graphics
- Beispiele Beispiele
- Beispiele für Tastenbefehle Beispiele für Tastenbefehle
- Bildobjekte Bild
- Bug reports Adresse des Autors
- Catalog-Dateien Locale
- Compilerunterstützung Programmers
- Copyright Copyright
- Danksagungen Danksagungen
- DeleteTool Goodies
- Diskinserted InputEvent-Klassen
- Diskremoved InputEvent-Klassen
- Distribution Copyright
- Distributionsdateien Distributionsdateien
- Dock-Objekte Dock
- Docs Verzeichnis Docs
- Dokumentation Docs
- E-Mail Adresse des Autors
- Einführung zu den ToolManager-ObjektenKonzepte
- Einführung zum ToolManager Einfuehrung
- Fragen Fragen
- Gedruckte Dokumentation Docs
- Genehmigungen Copyright
- Geschichte Geschichte
- GetPubName Goodies
- GiftWare Wichtig
- Goodies Verzeichnis Goodies
- Graphics Verzeichnis Graphics
- InputEvent-Klassen InputEvent-Klassen
- Installation (schnell) Schnellinstallation
- InterNet Adresse Adresse des Autors
- Kommentare Adresse des Autors
- Konfiguration Voreinstellungen
- Konzepte Konzepte
- L Verzeichnis L
- Library Dokumentation Docs
- Library Schnittstelle Library
- Libs Verzeichnis Libs
- List: Qualifier Qualifier
- Liste: rawkey Tastenkodes rawkey Tastenkodes
- Liste: rawmouse Tastenkodes rawmouse Tastenkodes
- Locale Verzeichnis Locale
- Lokalisation Locale
- Menüobjekte Menue
- Merkmale von V38 (und höher) Wichtig
- Objekte Objekte
- Piktogrammobjekte Piktogramm
- Postadresse Adresse des Autors
- Prefs Verzeichnis Prefs
- Programmers Verzeichnis Programmers
- Programmkonzepte Konzepte
- Programmobjekte Programm
- Programmversionen Geschichte
- Qualifier Qualifier
- Quelltext Source
- Rawkey InputEvent-Klassen
- Rawmouse InputEvent-Klassen
- Rechtliche Dinge Copyright
- Referenz: Distributionsdateien Distributionsdateien
- Referenz: Library Schnittstelle Library
- Referenz: Tastenbefehle Tastenbefehle
- Referenz: ToolManager-Objekte Objekte
- Referenz: Voreinsteller Voreinstellungen
- Schnellinstallation Schnellinstallation
- Scripts Verzeichnis Scripts
- Shell-Skripte Scripts
- Source Verzeichnis Source
- Spenden Adresse des Autors
- Sprachdateien Locale
- Sprachen Locale
- Tastenbefehle Tastenbefehle
- Tastenkodes für rawkey rawkey Tastenkodes
- Tastenkodes für rawmouse rawmouse Tastenkodes
- Texinfo Docs
- Tonobjekte Ton
- ToolManager-Objekte Objekte
- UPD Goodies
- Verbote Copyright
- Versionen Geschichte
- Voreinsteller Voreinstellungen
- WBStart 1.2 L
- WBStart-Handler L
- WBStartup Verzeichnis WBStartup
- Wichtige Bemerkungen Wichtig
- Zugriffsobjekte Zugriff
-
-